Public Function assign_action_item(ByVal the_id As String, _
ByVal new_user As String, _
ByVal wipbin_name As String, _
ByVal assign_date As String, _
ByVal user_name As String, _
ByVal gen_time_bombs As Boolean) As Integer
Public Function assign_opportunity(ByVal the_id As String, _
ByVal new_user As String, _
ByVal wipbin_name As String, _
ByVal assign_date As String, _
ByVal user_name As String, _
ByVal gen_time_bombs As Boolean) As Integer
Public Function assign_quote(ByVal the_id As String, _
ByVal new_user As String, _
ByVal wipbin_name As String, _
ByVal assign_date As String, _
ByVal user_name As String, _
ByVal gen_time_bombs As Boolean) As Integer
Description
These APIs cause the specified action item, opportunity, or quote to be assigned to a new user. The object must be in open condition, and the user assigning the object does not have to be the owner of the object. In base Clarify, the assigner of a object must be the owner. If either user name is not specified, the "current" user is used. The date/time of the assignment, and the WIPBin to place the object in can also be specified. Allowing a WIPBin other than the default one is also an augmentation from base Clarify. The API can also generate a time bomb (for business rule notification).
Parameters
Parameter Name Required? Description
the_id Yes The action item, opportunity, or quote ID to be assigned
new_user No The user who the object is assigned to. If left blank, the object is
assigned to the current user
wipbin_name No The WIPBin to place the object in (for the user who is assigned the
case). If left blank, the object is placed in the user's default WIPBin
assign_date No When was the object assigned. If this parameter is left blank, the case
is assigned at the current time
user_name No The user who assigned the object If left blank, the current user performs
the assign
gen_time_bombs Yes Should a time_bomb be generated (for notifications/business rules)
Returns
Value Meaning
0 No errors
-1 Cannot find the specified action item, opportunity, or quote
-2 The specified object is not currently open
-3 Specified user (to assign to) is not found
-4 The specified WIPBin is not valid for the user
-5 Specified user (who performed the assign) is not found
-6 Cannot find gbst_elm rank 10500 for string ASSIGN
Examples
· Assign action item number '10' to user 'marty'. The assign is performed by the current user, is placed in the default WIPBin and is assigned at the current time. Generate a time bomb.
JavaScript:
var ret_int = fcsfa.assign_action_item("10", "marty", "", "", "", true);
Visual Basic:
Dim ret_int As Integer
ret_int = fcsfa.assign_action item("10", "marty", "", "", "", True)
· Assign opportunity number '2' at 10PM on November 23rd of 1997 to marty, and place it in marty's WIPBin named 'Urgent'. Assign should be logged as performed by sam. Don't generate a time bomb.
JavaScript:
var ret_int = fcsfa.assign_quote("2", "marty", "Urgent",
"11/23/97 22:00:00", "sam", false);
Visual Basic:
Dim ret_int As Integer
ret_int = fcsfa.assign_quote("2", "marty", "Urgent", _
"11/23/97 22:00:00", "sam", False)